home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / PMS_100.ZIP / PMSTRIP.DOC < prev    next >
Encoding:
Text File  |  1996-03-30  |  7.7 KB  |  245 lines
  1.   
  2.                           PMStripper 1.0
  3.  
  4.  
  5. I. Overview:
  6.  
  7.  
  8. This PM shareware utility strips HTML codes from Web pages,
  9. leaving only the text.  Some of the page's formatting is
  10. retained, but since PMStripper is not an HTML interpreter most
  11. formatting is lost.  While the layout of tables and lists is lost
  12. during stripping, data is sorted to separate lines for
  13. legibility.
  14.   
  15. PMStripper is designed to provide a quick conversion of HTM/HTML
  16. coded files into plain ASCII text.  Although the converted files
  17. can be edited while loaded in PMStripper, only simple edit
  18. commands are available.  Therefore, if extensive editing is
  19. needed, the text should be loaded into a more capable word
  20. processor or text editor.
  21.  
  22. The registered version offers a menu item to easily move stripped
  23. files to programs suited for advanced editing.
  24.  
  25.  
  26.  
  27. II.  Installing PMStripper:
  28.  
  29.  
  30. 1) Unzip the archive.
  31.  
  32. 2) If REXX is installed:  Run the INSTALL.CMD script from an OS/2
  33. command prompt, or by double clicking on the install file's icon.
  34.         
  35. The script will create a destination directory and transfer
  36. program files to it.  Optionally, you may use the unzip directory
  37. as the working directory.  In either case the script will create
  38. a PMStripper program object on the desktop and set file
  39. associations for .HTM and .HTML files.  Setting associations this
  40. way allows instant loading, and stripping, of saved web pages by
  41. double clicking their icons.
  42.  
  43. If the install program cannot create the desired directory, just
  44. move all unzipped files to the working directory before running 
  45. the install program.
  46.   
  47. 3) If REXX is not installed:  Unzip the archive in the desired
  48. working directory and manually:  a) Create a desktop program
  49. object, and b) Set .HTM and HTML associations.  (See OS/2
  50. documentation for instructions, if needed.)
  51.  
  52.  
  53.  
  54. III.  Files
  55.  
  56.  
  57. PMStripper is distributed in the compressed archive PMS_xxx.zip,
  58. where xxx is the version number.  The archive contains these
  59. files:
  60.  
  61.  
  62. NAME              SIZE          DESCRIPTION
  63.  
  64. INSTALL.CMD       2324    Install script.
  65. LICENSE.TXT       4177    License.
  66. PMSTRIP.EXE     442368    Program executable.
  67. PMSTRIP.ICO        874    Program icon.
  68. PMSTRIP.DOC       7917    This file.
  69. README.UNH         492    Information file for unh.exe. 
  70. UNH.EXE          38400    Command line stripper.
  71.  
  72.  
  73.  
  74. IV.  Uninstalling PMStripper:
  75.  
  76.  
  77. If you find it necessary to remove PMStripper, simply delete the
  78. unzipped files, program object, associations and directory.
  79. PMStripper makes no entries in configuration or initialization
  80. files.
  81.  
  82.  
  83.  
  84. V. Using PMStripper
  85.  
  86.  
  87. PMStripper is a simple program with only six menu bar items:
  88.   
  89. 1. 'File' offers three pull-down menu item:  'Open', 'Save as'
  90. and 'Exit'.  Each perform in a standard OS/2 manner. Picking a 
  91. saving file name is easy: Highlight some text for the name and 
  92. then click on 'Save as', or simply highlight and Alt+S.
  93.  
  94. The utility will also load HTML coded files for stripping via
  95. drag and drop of the file's icon onto that of the PMStripper.
  96. However, the capability to load files by drag and drop onto an
  97. open edit window is a potential enhancement, for a future
  98. version.
  99.  
  100. 2. 'Edit' has four sub-menu items which also operate as expected.
  101. They are 'Cut', 'Copy', 'Paste' and 'Select All'.
  102.   
  103. 3. The 'Options' menu item allows the user to select the 'Font'
  104. and toggle 'Word wrap'.  The wrap function does not actually
  105. reformat the text, instead it effects only the way text is
  106. displayed.
  107.   
  108. 4. 'Word Processor' loads the stripped file into an external
  109. editor.  This option is only active in the registered version.
  110.   
  111. 5. 'Exit' causes the stripped file to be discarded and PMStripper
  112. to close.  NOTE:  Double clicking the PMStripper's upper left corner,
  113. using Alt+F4 or selecting that menu's 'Close' will cause the
  114. temporary stripped file (named __TMP2__ ) to remain in the source
  115. file's directory.  
  116.  
  117. 6. 'About' displays copyright and contact information.
  118.  
  119.  
  120.  
  121. VI.  The active keyboard accelerators (short cut keys) are:
  122.  
  123.  
  124.         Exit            Alt+X
  125.         Copy            Ctrl+Insert
  126.         Cut             Shift+Delete
  127.         Select All      Ctrl+/
  128.         Open            Alt+F
  129.         Paste           Shift+Insert
  130.         Save as         Alt+S
  131.         Word Processor  Alt+W
  132.  
  133.  
  134.   
  135. VII.  Miscellaneous Notes:
  136.   
  137.  
  138. When dragging a file from WebExplorer the file must be dropped on
  139. the desktop (or in a folder) before it can be dropped on the
  140. PMStripper program object.
  141.  
  142. This utility will only run on OS/2 Warp and later releases.
  143.  
  144. One useful feature is the ability to mark text in the stripped file
  145. and use the highlighted text as the file's 'save as' name. This
  146. is very useful if you have HPFS formatted drives.  NOTE: Spaces
  147. and some punctuation characters are converted to "_" characters
  148. in the file name.  The "/" and  "\"  characters are deleted and
  149. not replaced.  This feature is only activated in the registered
  150. version of PMStripper.
  151.  
  152.  
  153.  
  154. VIII.  Why & How to Register:
  155.  
  156.  
  157. The Word Processor option runs the PMS_CMD.CMD file located in
  158. the working directory specified in the Program Object.  This file
  159. is used to start the word processor or editor of your choice to
  160. edit the stripped text file named __TMP2__.  PMStripper will
  161. close after the executing the PMS_CMD.CMD file.  NOTE:  The
  162. __TMP2__ file is discarded if PMStripper is closed via the the
  163. 'Exit' menu item.
  164.  
  165. This menu item is disabled in the unregistered version.  Instead
  166. of invoking the command script an unregistered message requiring
  167. a user response will be shown.
  168.  
  169.  
  170. Example PMS_CMD.CMD files:
  171.   
  172. To use the system editor E.EXE, the PMS_CMD.CMD file would
  173. contain:
  174.  
  175.         E __TMP2__
  176.   
  177. To use a word processor or editor whose executable is not in the
  178. path, the command script must copy the __TMP2__ file to the
  179. desired program's data directory, change to that directory and
  180. then launch the word processor/editor.  An example PMS_CMD.CMD
  181. file to use DeScribe is shown below.
  182.  
  183.         copy __TMP2__ g:\describe\__TMP2__ 
  184.         g:
  185.         cd \describe 
  186.         describe __TMP2__
  187.  
  188. In addition to the activation of the Word Processor option,
  189. the opening unregistered message requiring a user response
  190. is eliminated along with the unregistered line that is
  191. inserted at the top of the stripped file.
  192.  
  193. Registered users are supported via e-mail. Send help requests and 
  194. good ideas to me at dwhawk@southwind.net.
  195.  
  196. To register: stuff small bills, gold coins, diamonds or even 
  197. checks (US banks only, please) valued at $7.50 (US dollars) into
  198. an envelope and mail to:
  199.  
  200.  
  201.         Don Hawkinson 
  202.         4555 N Hillcrest
  203.         Wichita KS, 67220-3832
  204.  
  205.  
  206. Please don't send $100 bills (or larger) in the mail without 
  207. purchasing full postal insurance. Also, no change will be 
  208. returned because it is absolutely unsafe, and unwise, to send 
  209. cash through the mail.
  210.  
  211. The registered version of PMStripper will be distributed by e-mail
  212. in the form of a uuencoded zip file. If you require a copy of the
  213. registered version mailed to you on floppy disk, please enclose
  214. an additional $5.00 (outside US add $10.00).
  215.  
  216. Updates to the utility will be distributed via e-mail in the form
  217. of a uuencoded zip file.  Registered users will be notified of
  218. updates via e-mail.
  219.  
  220.  
  221.  
  222. IX. Acknowledgments:
  223.  
  224.  
  225. Thanks to the following netizens for their help in testing
  226. and helpful comments during development.
  227.  
  228. DenverD@ibm.net
  229. Emil_Kucera@Environment.gov.MB.CA 
  230. fvlaming@netcom.com
  231. jhiatt@ibm.net
  232. jlink@best.com
  233. p_daley@conknet.com
  234. tombeck@usemail.com
  235.  
  236. Thanks to a net WordSmith (WrdSmth@IBM.net) for editing help.
  237. (Actually he converted my very rough draft to this document.)
  238.  
  239.  
  240. Copyrights and trademarks remain the property of their owners.
  241.  
  242.  
  243. Don Hawkinson 
  244. dwhawk@southwind.net
  245.